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PREFACE 


This manual describes the DOS-15 System Generator Utility Program, 
DOSGEN, and gives other information needed by the System Manager 
for installation and maintenance of the DOS-15 system. 

In the preparation of this manual, it was assumed that the reader 
is familiar with the Disk Operating System (DOS-15) , including its 
Monitor, and the several Utility Programs — especially PIP, PATCH, 
and UPDATE. The DOS SOFTWARE SYSTEM, USER'S MANUAL (DEC-15-MRDB-D) 
describes the general operating procedures for DOS-15. 


PDP-15 UTILITY PROGRAMS MANUAL, (DEC- 15- YWZB-D ) 

The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the operation and use of a PDP-15 
Utility program. The set of manuals which make up the Utility 
Programs manual are listed in an Applications Guide located on the 
following page; the Guide also lists the order number of each manual 
and indicates the currently available monitor systems under which the 
program will operate. 

Individual utility manuals may be ordered by referencing the titles 
and order numbers specified in the Applications Guide. A complete 
set of utility manuals may be obtained by ordering "PDP-15 Utility 
Programs Manual, DEC-15-YWZB-D" . 
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APPLICATION GUIDE 


PDP-15 UTILITY PROGRAM MANUALS 


PDP-15 Utility Program Manuals and the Application of Each 


Title 

Manual 

Order Number 
(DEC— 15-YWZB_) 

Applies to Monitor: 

DOS 

ADV 

B/F 

DDT 

Utility Program 

DN1 

/ 

/ 

/ 

CHAIN & EXECUTE 
Utility Program 

DN2 

/ 

/ 

/ 

SGEN 

ADVANCED Monitor 

DN3 


/ 


MTDUMP 

Utility Program 

DN4 

/ 

/ 


PATCH 

Utility Program 

DN5 

/ 

/ 

/ 

EDIT 

Utility Program 

DN6 

i 

/ 

/ 

/ 

UPDATE 

Utility Program 

• 

DN7 

/ 

/ 

/ 

LINKING LOADER 

DN8 

/ 

/ 

/ 

PIP 

ADVANCED Monitor 

DN9 


/ 

/ 

SRCCOM 

Utility Program 

DN1 1 

/ 

/ 

/ 

SGEN 

DOS Monitor 

DN12 

/ 



PIP 

DOS Monitor 

DN13 

/ 



Disk SAVE/RESTORE 
Programs 

DN14 

/ 

/ 

/ 
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DOSGEN 


INTRODUCTION 

Sections one and two of this manual describe DOSGEN and its use. 
Section three describes the general sequence of operations to be 
followed when using DOSGEN. It is recommended that the user read 
the entire manual before installing DOS-15. 
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DOSGEN VIA 


1.1 Context 


The DOS System Generator, DOSGEN VIA, allows the system manager to 
modify an existing DOS system to suit the needs of a particular in- 
stallation. DOSGEN does not create a system, but modifies an exist- 
ing one. The DOS disk restore DECtapes or magtape that Digital Equip- 
ment Corporation distributes will produce a working Disk Operating 
System when restored to the disk via the DOSSAV program 1 . The system 
manager may initiate a system generation operation in order to tailor 
this basic system to hxs own needs by issuing the following series of 
commands to the DOS Monitor: 


MICLOG SYS 

A DK ^14 
A DP t14 


Required System Manager Password for the basic system 

(for system generation on RF DECdisk) Required AS- 

(for system generation on RP Disk Pack) SIGN statement 


SGEN 


Load command for DOSGEN 


When DOSGEN is loaded it automatically starts an interactive SGEN pro- 
cedure. Once system generation is complete, the system manager should 
save the changed system via the DOSSAV program. He should always re- 
tain at least two copies of the system: the original tape(s) from DEC, 
and a copy of the new system. 

Should the system manager wish to do a subsequent system generation, he 
should type the same command series given above, substituting the Master 
Identification Code which he supplied during the last system genera- 
tion. 


1.2 Organization 

DOSGEN is a single, core-image system program with no overlays. When 
loaded into core DOSGEN tests to ensure that the system owner is cur- 
rently logged in and that the "A" handler of the RF DECdisk or RP Disk 
Pack is assigned to .DAT-14. DOSGEN will exit if these requirements 
are not met. DOSGEN then types out its name, version number, and the 
device and unit number on which the new system will reside. 

1 Appendix a describes the DOSSAV program. 
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DOSGEN then proceeds with eight sequentially presented sets of ques- 
tions that can modify three basic areas of the system: (1) system 

parameters, (2) I/O, and (3) system programs. The eight sets of 
questions are identified by the letters A through H. Each set is 
started by a key question that describes the drift of the questions in 
that particular set. Key questions start at the left margin, questions 
within a set are tabbed one stop (8 spaces} to the right. 

The user can save time by refusing to consider questions in a parti- 
cular set involving an area not to be modified. He can do this by 
responding to the key question of any set with a Carriage Return, which 
effects the acceptance of a set of default answers. This means that 
the parameters covered by the rejected set will remain as in the pre- 
vious system. 

DOSGEN provides restart points which coincide with the beginning of 
each set of questions. In general, a CTRL P from the keyboard at any 
point before the end of the current set of questions will cause a re- 
turn to the start of the current set of questions, and the deletion of 
all answers previously supplied for the current set. Before the user 
terminates a particular set, therefore, he should check all answers 
for that set. If he later finds a mistake after a set is completed, 
he will have to abort the operation and go through another complete 
system generation to correct the error. A CTRL C at any time before 
the end of Section H will terminate the system generation, leaving 
the old system unchanged. 

1.3 Answers to DOSGEN Questions 

1.3.1 Teleprinter Command Mode 

To save time, DOSGEN supplies a default answer with each question in 
parentheses. The default answer always shows how the previous system 
looked or in some way indicates no change is required. A Carriage 
RETURN response indicates the user accepts the default answer. In 
the illustration of each question where the default may be more than 
one, this manual will indicate the possibility with brackets ( {} ) 

Thus : 

API { (Y) } 

API l (N) i 
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Y and N are one-character answers for many of the Yes/No, On/Off class 
of questions. They are self-explanatory. In the case of some ques- 
tions, however, a third one-character choice is required. In such 
questions, the third choice implies "Yes, but ask me questions about 
the details of the subject." For example. Section B, which concerns 
devices and device handlers, first asks about each device, deferring 
questions about its handlers until necessary. Thus, the question: 


PR? ($) 


asks whether the user wants the Paper Tape Reader. "N" says "NO, de- 
lete the Paper Tape Reader and all of its handlers and skips from the 
system." Response K $" or Carriage Return says, "YES, keep the Paper 
Tape Reader and all its handlers and skips as they are." Response "Y" 
says, "YES, keep the Paper Tape Reader, but ask me questions about 

its handlers and skips." ALT MODE alone will be echoed "$" , and sub- 
stitutes for " $" . For the Y/N/$ type of question, which accepts a 
one-character answer, a left arrow will imply the default and give a 
visible answer on the printout. (Carriage RETURN is not a printing 
character. ) 


Some questions allow multiple answers? for example, "SKIP MNEMONICS 
IN ORDER" (paragraph 2.4.2). In such instances, the user may type 
several answers on one line, separating each answer with a comma. 

Other answers will be explained in the relevant parts of paragraph 2. 


1.3.2 DOSGEN Batching Command Mode 

Like other system programs, DOSGEN may be used in the DOS Batching Com- 
mand Mode. In fact, some features have been added which make batching 
processing easier. These features are required for the following 
reason: For those answers whose defaults are specified in parentheses , 

DOSGEN reads teleprinter input in Image Alphanumeric Mode. Hence, it 
does not require a Carriage RETURN to complete a .READ. System con- 
siderations, however, require that Batching Mode tapes or decks be in 
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IOPS ASCII. This means that each line of input must be terminated by 
a Carriage RETURN. Since lines containing one Carriage RETURN only 
cannot be generated by the Editor/ the default answer must always be 
specified by a left arrow (+-) . One-character answers in teleprinter 
mode have their Batching Mode equivalents as follows: 


Teleprinter 


Batching 


Y 

N 

$ 


Y) 

N J 


Carriage RETURN 
or 

Left- arrow («-) 


All of the above types of answers go with questions where the default 
is specified in parentheses. In any case where the default is not 
specified in parentheses (i.e./ no default, or one in brackets), the 
user should have xx.,*) in the batching command string. 


1 . 4 Error Mes s ag es 

DOSGEN checks all answers for syntax and acceptability to the DOS soft- 
ware. It also does some limited checking for acceptability within the 
current hardware configuration. Whenever DOSGEN finds a wrong answer, 
it types an error message two tabs to the right of the left hand margin 
Cl 6 spaces in). DOSGEN does not check for multiple errors; any answers 
that follow an erroneous answer on the same line are not processed, and 
must be retyped. 

1.5 Operation 

When DOSGEN starts operation, it saves an image of the three parameter 
blocks from the system device plus the Storage Allocation Table. These 
blocks contain the old image of the three system information blocks: 
SGNBLK, SYSBLK and COMBLK . SGNBLK contains information about the de- 
fault settings of key . SCOM registers, the .DAT and . UFDT , plus an 
ordered skip chain, the names of all the handlers, and certain informa- 
tion about the devices that the system knows about. Together, SYSBLK 
and COMBLK occupy two contiguous blocks on the system device. They 
describe the system programs. Figure 1-1, SGNBLK, and Figure 1-2, 
SYSBLK and COMBLK, illustrate the contents of these information blocks. 
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LiOCdCiun 


Description 


000 nnn 

000015 

000nnn 


000nnn 
r041300'\ 
^0 42000 J 


5 

nnnnnn 

5 

nnnnnn 

7 

nnnnnn 

10 

nnnnnn 

11 

.SIXBT 

12 

nnnnnn 

13 

00000 n 

14 

00 nnnn 

15 

7777nn 

16 

000 nnn' 

53 

000 nnn 

54 

.SIXBT 

111 

.SIXBT 

112 

nnnnnn' 

137 

nnnnnn 

140 

.SIXBT 


. SIXBT 
. SIXBT 


.SIXBT 

000003 

nnnnnn 

nnnnnn 

nnnnnn 

.SIXBT 

000001 

nnnnnn 


Pointer to first free entry in SGNBLK 
Number of miscellaneous parameters 
Size of. DAT plus size of . UFDT = (number of 
positive .DAT slots + 16] *2. (Initial value 
is 20 positive .DAT slots.) 

Number of skips in Skip Chain 

System device code (RP02=20, RF15=15] 

Original contents of .SCOM+4 
Original contents of . SCOM+20 
Number of words per buffer (.SCOM+27 
Default number of buffers (.SCOM+261 
Monitor Identification Code 
Information on VT and CTRL X (.SCOM+33) 
Default files protection code (.SCOM+54) 

Size of the Resident Monitor Patch Area 
Minus the number of clock ticks in a second 
(-74 for 60 hz, -62 for 50 hz) 

Device assignments for the .DAT (made by 
handler numbers) . (Termination at 53 assumes 
20 positive slots.) 

UIC assignments for the .UFDT. (Termination 
at 111 assumes 20 positive slots.) 


Skip Chain Table (Negative skips in one's 
complement.) (Termination at 137 assumes 
22 skips in chain.) 

The last part of the SGNBLK is the Device 
Handler-Skip IOT Table. Each entry starts 
with the .SIXBT representations of all 
handlers for a particular device. (First two 
characters equal device code , for all 
handlers.) Zeroes in the first six bits of 
a word indicates the end of the handler 
names , and says that the rest of the word 
contains the number of skips for this entry's 
device. The skip IOT's follow immediately. 

As above, one's complement skips indicate 
negative skips. Note, however, the confusing 
fact that a one's complement of a skip IOT 
is a positive number. Thus, 70nnnn comple- 
mented is 07 nnnn. 


SGNBLK ends at 312, in the DOS-15 system 
distributed by Digital Equipment Corporation. 


SGNBLK 


5 



Word # 

9 


Value Description 


000nnn Pointer to first free word after SYSBLK 

(There is one set of seven words/core 

SIXBT'* image program.) 

' SIXBT } Narae of System Program or overlay 

nnnnnn Number of first block on system device 

occupied by this program or overlay 

0000nn Number of blocks occupied by this 

program or overlay 

addres Thirteen-bit first address for this 

program or overlay 

jZnnnnn Program size 

addres Thirteen-bit starting address for this 

program or overlay 



400 

' 000010 

401 

. SIXBT 

402 p 

. SIXBT 

403 

.SIXBT' 

404 r 

. SIXBT’ 

405 o j 

* 000002 


411 r 

412 

413 o 

g 

414 2 


. DAT Still 
. DAT Still 


000005 

.SIXBT' 
. SIXBT- 
000001 


-. DAT&777 


Number of words in this entry (in this 
case, Ij2f) 

Name of this system program (left- 
justified and zero-filled) 

Name of an overlay ( left- justified and 
zero-filled) — overlays are optional 
Number of buffers required by this 
system program (Bits 0-6=0 means the 
end of any overlay names. This is why 
program and overlay names must be 
left- justified. ) 

Active .DAT slot 

Active .DAT slot (Note: 777777 for a 
.DAT slot means all positive .DAT slots, 
Number of words for this entry (in 
this case, 5) 

Name of this system program 

Number of buffers required by this 
program (Note that this program has 
no overlays.) 

.DAT slot for this program 


000400 Pointer to first word in COMBLK (equals 

count from first word in SYSBLK) . The 
two contiguous blocks on the system 
device that hold SYSBLK and COMBLK are 
treated by the system as one large 
block. In this case, COMBLK happens to 
start at location 400 of the two blocks 
combined. 
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Appendix D contains listings of these information blocks, as supplied 
by DEC. 

Most of DOSGEN *s operations consist of building new images of SGNBLK , 
COMBLK and SYSBLK and the Storage Allocation Table. On completion 
of the last set of questions (the "H" set) , DOSGEN disallows commands 
from the teleprinter, writes out the new system block images, and de- 
letes any discarded handlers from the IOS User File Directory. (Up to 
that point, the current system had remained unchanged.) It is up to 
the user to insert added handlers and system programs. Handlers may 
be added via PIP. PATCH may be used to add core-image system programs 
for which DOSGEN has allocated space. 


2. DETAILED DESCRIPTION OF OPERATION 


This section describes the options available to the DOSGEN user , and 
explains some of the planning necessary for determining an optimum 
configuration for a particular installation. Each first order (two-digit) 
paragraph denotes a new set of questions, each second order (three- 
digit) paragraph presents an individual question and a description 
of its meaning and use. 

2.1 A. ALTER SYSTEM PARAMETERS? (N) 

The ,l A u section defines those system parameters that do not fall under 
I/O or system program categories. Some are default parameters which 
may be modified by commands to the Nonresident Monitor. Others may 
only be modified by DOSGEN. Figure 2-1, Section A Questions, illus- 
trates this section. 

2.1.1 API? { } 

This asks whether API is available on the system, and whether the user 
wishes the default to be API on or off. A "Y" response makes "API ON" 
the default condition. An "N" answer makes "API OFF" the default. 

The Nonresident Monitor's API ON/OFF command can change the state of 
API temporarily. 

2.1.2 33TTY{^} 

This asks which keyboard (KSR-33 or KSR-35) is usually available for 
command inputs. The Resident Monitor 1 s teleprinter handler handles 
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DOSGEN VIA 


SYSTEM UPDATE ON DK0 
A. ALTER SYSTEM PARAMETERS? (N) Y 
API? CN> Y 
33 TTY? <N> N 
MICISYS] ABC 
DEFAULT # BUFFERSI3 1 4 
# WORDS/BUFFER [500] 525 
EXTRA 4K? <N> N 

DEFAULT FILES PROTECTION C0DEI2] 1 
RESIDENT PATCH AREA SIZEI0] 2500 
PAGE MODE SYSTEM? <N) Y 
60 CPS? (Y) Y 


FIGURE 2-1 
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both machines with no modification. It simply needs to know which con- 
sole it is talking to- An "N" response makes the Model 35 keyboard the 
default machine. A "Y" response makes Model 33 the default. The Non- 
resident Monitor* s 3 3 TTY command can change the default temporarily. 

2.1.3 MIC [mic] 

This question prints the current Master Identification Code (MIC) in 
square brackets, A Carriage Return entry retains the old MIC. If the 
user wishes to change the current MIC, he should type exactly three 
printing characters, followed by a Carriage Return. If possible, the 
user should avoid MIC codes that equal User Identification Codes (UIC f s) 
current to the system. In particular, he must avoid the following 
UIC's: ???, PAG, BNK, IOS , CTP and SCR. DOSGEN will not accept non- 

printing characters as part of an MIC. 

2.1.4 DEFAULT # BUFFERS [n] 

This command requests a default number of buffers to be allocated for 
user programs and non-core image system programs. The number in 
square brackets is the old number. If the user wishes to retain the 
old default number, he should type a Carriage Return. DOSGEN accepts 
any set of 6 or fewer octal digits followed by a Carriage Return as 
the octal number. The Master Tapes which Digital Equipment Corporation 
distributes indicate three (3) as a default number. The user must 
consider the trade off of the available core in his installation 
(systems with little memory might need a smaller number of buffers) 
versus the convenience of a large number of buffers. 

This parameter does not affect core-image system programs, which al- 
ways get as many buffers as they need. Users whose programs need a 
different number of buffers may use the BUFFS Nonresident Monitor com- 
mand to allocate the exact number of buffers needed. 

2.1.5 # WORDS/BUFFER [nnn] 

This requests the number of words per buffer, and prints the old 
number (in octal) in square brackets. A decision regarding an effi- 
cient size for the buffers requires some knowledge of the disk handlers, 
which use them. The handlers break buffers from the pool into three 
parts: Cl) File Information (about 40* words), (2) the Block List — 

addresses of pre-allocated blocks (between 4 and 374^ addresses, in- 
clusive), and (3) the data buffer (400g words). Thus, buffers must 
be at least 444^ words long. 
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The disk handlers will not use extra words in buffers longer than 103 4 Q . 
This, therefore, may be an upper limit on buffer size, unless other 
programs need more space in their buffers. The larger the Block List 
that is, the larger the buffer — the faster will be output. Smaller 
Block Lists may give more efficient allocation of disk space, and will 
certainly save core. 

Any number typed will be interpreted as an octal number. 

2.1.6 EXTRA 4K? { } 

For systems with an odd number of memory pages, a "Y" answer will allow 
the loaders to use the highest page in memory. For systems with no 
extra 4K page, the user should type "N" . 

2.1.7 DEFAULT FILES PROTECTION CODE [n] 

This requests the default file protection code, and prints the old 
code in square brackets. The possible codes and their meanings are: 

Code = 1 Unprotected, with the exception that the file 
may not be deleted and the number of blocks 
may not change, if the directory is protected. 

Code = 2 Write protected, if directory protected. 

Code = 3 Read/Write protected, if directory protected. 

DOSGEN will accept any one-digit octal number, but the numbers J2f, 4, 5, 
6, and 7 are meaningless in this system. 

The default protection code for User File Directories is always 1, 
protected, and may not be changed by DOSGEN. 

If users wish to temporarily change the default protection they may 
use the Nonresident Monitor Command PROTECT. 

2.1.8 RESIDENT PATCH AREA SIZE [nnn] 

This requests the Resident Monitor 1 s Patch area size and prints the 
old number in square brackets. The Resident Monitor 1 s Patch Area is a 
number of reserved registers (no bigger than 4700 g) located just above 
the Resident Monitor. The System Loader will not refresh it, except 
on Bootstrap loads, restarts, and any of the QFILE GET commands. The 
area may be used for patching the system or for communication among 
several programs in different core loads. 
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DOSGEN will interpret any number typed as an octal number. The digits 
8 and 9, therefore, will not be accepted. 

2.1.9 PAGE MODE SYSTEM? { ^| } 

This requests the default addressing mode. A M Y" response makes page 
addressing the default mode. An "N" response makes bank the default. 
Users may temporarily change the mode via the PAGE ON/OFF or BANK 
ON/OFF Nonresident Monitor commands. 


2.1.10 60 CPS? { 

This requests the line frequency at the installation. Installations 
with 6j2hz line frequency require a "Y M answer; those with 50hz require 
an ff N" response. 

2.2 B. ALTER I/O DEVICES OR HANDLERS? (N) 

This set of questions allows the user to delete or retain devices and 
all their handlers, and allows a third option of retaining the refer- 
ence to the device, and then retaining, deleting or adding handlers 
and skips for a particular device. The printout given in Figure 2-2 
illustrates the use of this section. 


Section B refers to all devices currently in the system by a two- 
character device code. The device codes for those device handlers 


included in the Master Tapes supplied by the Digital Equipment Corpora- 
tion are: 

CD Card Reader (CR03B or CR15) 

PR Paper Tape Reader (PC15) 

PP Paper Tape Punch (PC15) 

DT DECtape (TC15 DECtape Control) 

DK RF15 Disk Control 

DP RP15 Disk Pack Control 

LK LK35 Keyboard 

LP Line Printer (either LP15C or LP15F) 

MT MAGtape 

VP VP Point Plotting Display 

VT VT15 Graphic Display Console 

VW Writing Tablet 


(TT, which means teleprinter, is not included in this set of questions, 
because DOS uses the teleprinter as a console command device.) 

The device handler names used in Section B are printed as three-character 
names. In reality, handler names are four characters long, but this 
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FIGURE 2-2 
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section truncates the last character, a period (.). The first two 
characters must be the two-character device code for the handler* s 
device. The third character must be alphabetic. 

DOSGEN starts this set of questions by asking whether the user wishes 
to delete discarded handlers from IOS. Deletion saves space on the 
system device. 

DOSGEN then begins asking key questions for each device currently on 
the system: 

XX? t$) (where XX stands for any device code) 

If the user answers with a Carriage Return or DOSGEN retains the 

device and all its skips and handlers as they were in the previous 
system. If the user answers "N" , DOSGEN deletes all information about 
that device and its handlers, and all its skips from the Skip Chain. 
CDeletion of handlers from the handler UFD , IOS, does not occur until 
the termination of Section H.) 

If the user answers "Y", DOSGEN will ask specific questions about the 
handlers and skips for the device in question: 

2.2.1 XXX? (Y) 

(where XXX stands for any handler name) 

DOSGEN asks this question for each handler the device has in IOS. A 
*Y W response retains the handler; an "N" response deletes it. 

NOTE: DOSGEN does not allow the user to delete the "A" 

handler for the system device (DKA. or DPA . ) . 

2.2.2 NEW HANDLERS: 

When DOSGEN has asked a question for each of the device 's handlers cur- 
rently in IOS, it asks whether the user wishes to add any new handlers. 
It makes no sense to "add" a handler name which has just been deleted. 
If the user wishes to change a handler, he may use PIP to transfer a 
new one to IOS. PIP will automatically delete the old one if the user 
transfers a new one with the same name . New handler names should fol- 
low the rules outlined in paragraph 2.2. Whenever the user has no more 
handlers to add, he should simply type a Carriage Return. 
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Adding handler names only makes them "logically" present. The user 
must call PIP to transfer the handlers to the IOS UFD, in order to make 
handlers physically present. DOSGEN warns the user about missing 
handlers at the end of Section C. File names for handlers in IOS must 
have the same name as the handler global and a "BIN" extension 
(e.g., DKA.BIN). 

2.2.3 (Old skips) 

Presumably, the user changes old skips only in the case where they were 
incorrectly inserted. In any case, after the user has indicated he has 
no more handlers to add for the current device, DOSGEN prints the skips 
for this device that are in SGNBLK (whether or not these skips are in 
the skip chain) . DOSGEN prints skips in the following format: 

devskp = nnnnnn? (Y) 

A Carriage RETURN or "Y" accepts the old skip; an "N" deletes the skip. 

2.2.4 NEW SKIPS: 

When DOSGEN has exhausted the skips for the current device as they were 
in the old system, it requests any new skips. New skips should be 
typed in the following format: 

devskp = nnnnnn 

where devskp has no more than six characters, and nnnnnn starts with 
octal 70. DOSGEN rejects all other formats and repeats the ">" symbol 
which requests another skip. 

When the user types a Carriage RETURN after the ">", DOSGEN proceeds to 
the next device. Negative skips (that is, those which skip on "OFF", 
not "ON") should be preceded by a minus sign (-) , to indicate that they 
are negative: 

devskp = -nnnnnn 
2.3 C. ADD NEW DEVICE? (N) 

When DOSGEN has finished with Section B, it asks whether the user 
wishes to add a new device. Section C differs from other sections in 
that restarts (CTRL P) only delete information added for the current 
device. 

That is, if the user adds devices AA, BB, and CC, but types CTRL P 
during the CC operation, DOSGEN will return to a point just after the 
completion of the BB device insertion. 
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When the user has no more devices to add — that is, when he answers 
the key question with an "N" or Carriage Return, DOSGEN will remind 
him of all the handlers he has added to the system, but which are not 
yet present in IOS . He can add them later, via PIP. The printout of 
Figure 2-3 illustrates the use of this Section. 

2.3.1 DEVICE CODE [ ] 

Here, the user may type any two alphameric characters that DOSGEN can- 
not interpret as an octal number. It is recommended, however, that 
the user give only alphabetic characters, as any numerals might be con- 
fused with a unit number. DOSGEN will not accept any input other than 
two alphameric characters. There is no default for this question — 
that is, DOSGEN assumes that, if the user answered the Section C ques- 
tion with a "Y" , then he has a device code to add. DOSGEN makes no 
assumption about which device it is. 

2.3.2 NEW HANDLERS: 

Here, the user should add all the handlers he will use for the new de- 
vice. The names should follow the rules for handler names outlined in 
paragraph 2.2 with the exception that the user must not type the final 
period (. ) . 

The new skips for the device should follow the format outlined in 
Paragraph 2.2.4. DOSGEN adds all new skips to the end of the Skip 
Chain. The user may change the order of the Skip Chain in Section D. 

When the user has no more skips to add, DOSGEN repeats the key question 
for Section C, 

ADD NEW DEVICE? (N) 

If the user has another new device, he may add it now. 

2.4 D. CHANGE SKIP CHAIN? (N) 

When the user has responded to the key question for Section C with an 
"N" or a Carriage Return, DOSGEN proceeds to Section D, which allows 
the user to change the Skip Chain order and delete skips. The user may 
not add any skips in this section. The printout of Figure 2-4 illus- 
trates the user of this Section. 
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C. ADD NEW DEVICE? (N) Y 
DEVICE CODEC] AD 
NEW HANDLERS: 

>ADA 

> 

NEW SKIPS: 

>705432 

("705432" ISN’T SYMBOL) 
>ADSKP=705432 

>ADON=705332 

>ADO FFr702345 

> 

C. ADD NEW DEVICE? (N) N 

MISSING HANDLERS: 

DKD. 

DKF. 

ADA. 


FIGURE 2-3 
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D. CHANGE SKIP CHAIN? (N) Y 


SKIP MNEMONICS IN ORDER 


DISPLAY SKIP 

CHAIN? (Y) <- 

>ADSKP 

DEFAULT SKIP 

CHAIN ORDER: 

>SSPFAL 

SPFAL 

DTDF 


>$DTDF 

DSSF 

DPSJ 


>ADON 

MTSF 

SPDI 


>SDSSF 

WTSK 

SDDF 


>$DPSJ 

RCSF 

PCSD 


>ADOFF 

CLSF 

LSDF 


>$MTSF 

PSF 

PSF 


>$SPDI 

KSF 

SPKF 


>$WTSK 

TSF 

DTEF 


>$SDDF 

DPSE 

MPSNE 

MPSK 

SPE 


>$RCSF 

>$PCSD 

ADOFF 

ADON 


>$CLSF 

ADSKP 


>$LSDF 



>$RSF 



>$PSF 

(continued 

at right) 

>$KSF 



>SSPKF 



>$TSF 



>$DTEF 



>$DPSE 



>$MPSNE 



>$MPSK 



>$SPE 



>$ 


FIGURE 2-4 
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2.4.1 DISPLAY SKIP CHAIN? (Y) 

In most instances, the user will wish to see all skip mnemonics and 
acronyms in the old system, plus those he has just added. If he 
answers "Y" or Carriage Return, DOSGEN types: DEFAULT SKIP CHAIN 
ORDER, followed by the old Skip Chain with new skips at the end. 

2.4.2 SKIP MNEMONICS IN ORDER: 

Users have two basic options for this part: (1) accept the whole chain 

as is, or retype the entire chain, in a new order. The user may type 
a single Carriage RETURN in response to the "SKIP MNEMONICS IN ORDER:" 
question, and obtain the old chain order, with any new skips at the 
end of the chain. If he types any mnemonic, however, he must account 
for all of the skips. When the user responds to DOSGEN' s request for 
the next skip {> ) with an ALT MODE, DOSGEN types "$" and the first 
skip in the old chain that has not already been selected. When the 
user responds to the ">" with a Carriage RETURN, DOSGEN deletes all 
unlisted skips, freezes the new order, and continues on to Section F. 


Two warnings are in order: (1) Negative skips should be at the end of 
the chain. Illegal interrupts may otherwise occur when the peripheral 
device is down. (No standard DOS devices have negative skips.) 

(2) Beware of changing the relative order of the chain, as supplied 
by DEC. For instance, the clock interrupt must come before the printer. 


2.5 E. ALTER DEVICE PARAMETERS? (N) 


2.5.1 7 CHANNEL MAGTAPE 


(Y) 

(N) 


} 


The user should choose the proper default. "N" gives 9-channel. 


2.5.2 LINE PRINTER SIZE (80, 120, OR 132) [nnn] 


Acceptable responses to this question are 80, 120, or 132, or a Carriage 
Return. A Carriage Return will retain the old line size, printed in 
square brackets. 

2.5.3 VT ON: { } 

This requests the default setting for the CTRL X option. A "Y" makes 
VT ON the default. An "N" makes VT OFF the default. DOSGEN does not 
ask this question or the next one if the VT is not on the system. 

2.5.4 HALF ON? { } 

(N) 

This requests the default setting for the half-screen setting for the 
CTRL X option. An "N" response makes HALF OFF the default. A Si Y" 
response makes HALF ON the default. 
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E. ALTER DEVICE PARAMETERS? IN) Y 
7 CHANNEL MAGTAPE? (Y) N 

LINE PRINTER LINE SIZE(80,120, OR 132M80] 120 
VT ON? (N) «- 
HALF ON? (N) Y 


FIGURE 2.5 



FIGURE 2-6 
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2.6 F. 


ALTER .DAT SLOTS? (N) 


This section allows the user to alter the number of .DAT slots, which 
is a permanent change to the system (until the next System Generation) , 
and to make the default assignments to both the .DAT slots and the 
. UFDT slots. The operator may temporarily change the assignments via 
the ASSIGN (A) command to the Nonresident Monitor. (See Figure 2-6.) 

2.6.1 # OF POSITIVE .DAT SLOTS Inn] 

This asks the number of positive .DAT slots for the new system, and 
indicates the old number in square brackets. The number of negative 
.DAT slots is fixed at fifteen (15) . DOSGEN will accept any octal 
number from 1 to 77, inclusive. Each .DAT slot adds two registers to 
the size of the Resident Monitor and two parameters to SGNBLK — one 
for the .DAT slot entry, and one for the .UFDT entry.. Users with a 
great deal of core should still be careful about too many .DAT slots. 
That might cause SGNBLK overflow and an abort from the system genera- 
tion. Further, OTS users must reassemble FIOPS and . FLTB in order to 
use more than 20 ^ .DAT slots. See Appendix C. 

2.6.2 DISPLAY .DAT SLOTS (Y) 

If the user wishes to change any assignments, he may request their 
current assignments by answering "Y" or Carriage Return. This has the 
effect. of a REQUEST command to the Nonresident Monitor. 

2.6.3 NEW ASSIGNMENTS: 

The user may make new default assignments to the .DAT and/or .UFDT by 
using the same ASSIGN (A) commands he would use to the Nonresident 
Monitor. When the user has no more new assignments, he should type 
Carriage Return when DOSGEN types a new angle bracket (>) . UIC in a 
.UFDT slot means the UIC currently logged in will be given to that 
.UFDT slot. SYS in a .UFDT slot means either BNK or PAG will be 
assigned to that slot by the loaders (depending on the addressing mode 
of the load) . Any other three letters will be retained unless 
changed via an ASSIGN command. 

2.7 G. CHANGE SYS FILES? (N) 

With the exception of the first question, which refers to the size of 
thefQAREA, this section refers to the core-image system programs cur- 
rently listed in SYSBLK and COMBLK • This section allows no additions. 
The printout given in Figure 2-7 illustrates the use of this section. 
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ft 

G. CHANGE SYS FILES? (N) Y 

TQ AREA SIZE (NONE, 16K, 20K,24K,28K,32K) t 32K ] 16K 

TO BE KEPT: 

DOS 1 5? ($> $ 

EDIT? ($> N 

EDITVP? ($) $ 

EDITVT? ($) N 

PIP? ($) $ 

MACRO? ($) $ 

CHAIN? ($) $ 

F4? ($) $ 

DUMP? <$) $ 

DTCOPY? ($) $ 

PATCH? ($) $ 

UPDATE? ($) $ 

SPCCOM? ($) N 

8TRAN? ($) N 

89TRAN? ($) N 

MTDUMP? ($) N 

QFILE? ($) $ 

SGEN? <$) $ 

TKB? ($) $ 


FIGURE 2-7 
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2.7.1 IQ AREA SIZE (NONE , 16K , 2j2fK , 24K , 2 8K , 32K) [nn] 


DOSGEN does not ask this question for Disk Pack systems — they always 
receive 32K. 

This question allows the DECdisk user to set the IQ AREA size. Users 
with an RF disk system device may wish to delete the IQ AREA. In that 
case, they should type NONE, in response to this question. The Resi- 
dent Monitor will not allow dumps to a IQ AREA on the RF disk that is 
smaller than the current core size, or to a nenexistent area. The 
user should therefore avoid having an area which is smaller than his 
core size — it would simply waste space. "jg., 

must follow the numbers 

16, 20, 24, 28, or 32. 

Should the user need to make the IQ AREA larger, DOSGEN must try to 
find enough contiguous free blocks to hold the new one. If this proves 
impossible,, special steps may need to be taken. Refer to paragraph 

2. 7. 2. 2 for those steps. 

2.7.2 TO BE KEPT: 
syspro? ($) 

After the IQ AREA size has been defined, DOSGEN asks questions about 
each core-image system program currently on the system, in the order 
that it finds them in COMBLK . A response of "$" or Carriage Return 
instructs DOSGEN to* retain all information about the last-named system 
program. A response of "Y" instructs DOSGEN to retain the program's 
name in SYSBLK and COMBLK, but implies that the user wishes to change 
some of the information about the program, as listed in SYSBLK and 
COMBLK. An "N" will delete the program from the system. DOSGEN will 
not allow D0S15 to be deleted. 

2. 7. 2.1 ovrlay (Y) (where 'ovrlay" is the name of any cur- 

rently listed overlay) 

If the user responds to a system program name with a "Y" , DOSGEN first 
lists each of the program's overlays, if any. These are Yes/No answers. 

A "Y" or Carriage Return response retains that overlay, and an "N" 
response deletes it. 


22 



2. 7. 2. 2 OVERLAY NAME [] 

If the user wishes to add any overlays to the current system program, 
he should type the names at this point. DOSGEN will reject names which 
are more than six characters long, or are the same as any Nonresident 
Monitor or PATCH command. If the named overlay is already listed in 
SYSBLK, DOSGEN will request the next overlay. If not, DOSGEN will re- 
quest: 


# OF BLOCKS [] 


The user should type the number of blocks the new system program will 
occupy. If the number is legal, DOSGEN tests whether there are as 
many contiguous free blocks on the system device as are necessary 
to hold the new overlay. DOSGEN starts testing at block 0f of the 
system device, and stops as soon as it finds enough blocks. DOSGEN 
then updates its image of the Storage Allocation Table (SAT) to 
indicate that those blocks are occupied. 


Note that when disk space is tight, and the user wishes to add several 
system programs and overlays, DOSGEN may not allocate disk space effi- 
ciently. In an extreme case, the user may need to first transfer the 
BNK and PAG UFD f s (or even all of IOS , except the system device's "A" 
handler) off the disk via PIP, and then do one pass through DOSGEN to 
delete all unwanted system programs. Then the user must do enough suc- 
ceeding passes to ensure that system programs are added in order of 
size, with the largest first. Finally, the user should transfer the 
BNK and PAG UFD 1 s back, via PIP. This allows the UFD files, which 
need not be in contiguous blocks, to use up the noncontiguous blocks. 

Ordinarily, the procedure outlined in Chapter 3 should be sufficient 
to free all necessary disk space. NOTE ; New overlays or system pro- 
grams must run in Bank Mode. Use CHAIN for Page Mode programs. 

2. 7. 2. 3 BUFFS [nn] 

This question indicates the number of buffers previously allocated 
for this system program, and asks whether the user wishes to change 
the number. DOSGEN does not check whether the number of buffers al- 
located is compatible with the program. That is the user's responsi- 
bility . 
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2. 7. 2. 4 .DAT SLOT nn? (Y) 


After the user has indicated the number of buffers for this program, 
DOSGEN asks him to check the .DAT slots required. It first lists the 
old ones. If the user types Y or Carriage Return, DOSGEN retains the 
listed .DAT slot. An "N" deletes the listed .DAT slot. 

2. 7. 2. 5 .DAT SLOTS 

After checking the old .DAT slots, the user should add any new ones 
the program needs. The .DAT slots added must be legal, as determined 
in Section F. All positive .DAT slots may be obtained by typing 
"ALL ". If the user has added an overlay, he should add any .DAT slots 
needed by the overlay but not listed by DOSGEN for the system program. 


2.8 H. ADD SYS PROG? (N) 

This section allows users to add the names of new core-image system 
programs and their overlays to SYSBLK and COMBLK . Restarts in this 
section delete only the current system program, just as they do for 
new devices, Section C. 

The printout given in Figure 2-8 illustrates the use of this section. 

2.8.1 PROG NAME [] 

Names must conform to the rules for system program names outlined in 
paragraph 2. 7. 2. 2. There is no default for this question. 

2.8.2 # OF BLOCKS [] 

This question works just like that for overlays, described in paragraph 
2. 7. 2. 2. There is no default for this question. 

2.8.3 OVERLAY NAME [] 

Any overlay names must conform to the rules for system program names 
outlined in Paragraph 2. 7. 2. 2. If the overlay name is not already 
listed in SYSBLK, DOSGEN requests: 

# OF BLOCKS [] 
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2.8.4 BUFFS [0] 


The user should enter the octal number of buffers needed for the new 
system program. 

2.8.5 .DAT SLOTS: 

The user should list the octal numbers erf all .DAT slots needed by the 
new system program, or any of its overlays. The response "ALL^" obtains 
all positive .DAT slots. 

After the user has entered all necessary .DAT slots, he should type a 
Carriage Return in response to the "> " symbol typed by DOSGEN. This 
returns him to the start of Section H. 

If the user types Carriage Return or "N” to the key question for 
Section H, DOSGEN disallows CTRL P or CTRL C, modifies the system, 
and returns to the monitor. At this point, the user must do a 
Bootstrap restart, in order to bring in the modified system. 

3. DOSGEN AND ITS CONTEXT 


3. 1 Building DOS- 15 for the First Time 

Digital Equipment Corporation supplies DOS-15 on disk restore tapes — 
either one 7- or 9-track magnetic tape, or two DECtapes. In addition, 
users with optional Floating Point Hardware should obtain a tape with 
the Floating Point FORTRAN and Object Time Systems to accommodate that 
option. The disk restore tape(s) should be copied onto the system 
device via the DOSSAV program. Appendix A describes DOSSAV operation. 

After the completion of a DOSSAV run from the DEC restore tapes to the 
system device (disk), the disk will contain: 

1. A working DOS-15 system 

2. Completed images of three system information blocks: 

SGNBLK, SYSBLK, and COMBLK. 

3. Core-image files of the following system programs: 

D0S15, the Nonresident Monitor 
RESMON, the Resident Monitor. 

. SYSLD, the System Loader 

EDIT 

EDITVP 
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EDITVT 

PIP 

QFILE 

MACRO 

CREF, MACRO'S overlay for pass three 
CHAIN 

F4, the FORTRAN program for PDP-15 machines without 
floating point hardware 

DUMP 

DTCOPY 

PATCH 

UPDATE 

SRCCOM 

8 TRAN 

89TRAN 

MTDUMP 

DOS GEN 

TKB, the task builder for PDP-15 RSX 
The DOS-15 User's Manual, DEC-15-MRDA-D, gives brief descrip- 
tions of all these system programs, except TKB, the RSX Task 
Builder. See DEC-15-GRQA-D for information on TKB. 

4. Relocatable binary files in the IOS UFD. These files are 
handlers for the following devices: 

RF15 DECdisk Control 
RP15 Disk Pack Control 

PC15 High-Speed Paper Tape Reader and Punch Control 

VP15 Point Plotting Display 

VT15 Graphic Display Processor 

TC59 Magnetic Tape Control 

LP15C and LP15F Line Printers 

LK35 Keyboard 

TC15 DECtape Control 

CR03B Card Reader Control 

VW01 Writing Tablet 

Appendix B contains a listing of IOS, as supplied by the 
Digital Equipment Corporation. 

5. Relocatable binary files in the BNK and PAG UFD's. These 
files are the relocatable system programs: EXECUTE, .LOAD, 
FOCAL, and DDT, plus . LIBR, the system library. They load in 
Bank and Page Mode systems, respectively. Appendix B con- 
tains a listing of the BNK and PAG UFD's as supplied by DEC. 
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6 . 


Several source and binary files in the PER UFD. These files 
are for optional peripherals not included in the majority of 
the systems DOS-15 will serve, and for PDP-9 owners who wish 
to use DOS-15. Appendix C lists the PER UFD, as supplied by 
DEC, and describes the use of the routines contained in PER. 

7. A 32K CTRL Q Area. 

8. SCR, the default UFD. SCR will be empty. 


The above-mentioned files and information blocks will fit on the 
smallest system device supported by DOS-15, a single-platter RF15 
DECdisk. Part of the system generation process is designed to free 
the system device blocks occupied by unneeded handlers and system 
programs. This is especially important on one- or two-platter DECdisk 
systems to which the user intends to add his own system programs. The 
following procedure will free up disk storage and set up a new system 
in an orderly fashion: 

NOTE 

The user should be logged in under the Monitor 
Identification Code for all the following 
operations . 

3.1.1 Preliminary DOSGEN Run 

Call DOSGEN, set up the correct system parameters, and delete all un- 
desired device handlers and system programs. Do not add any new 
handlers or programs. If a DECdisk system, and the computer’s main 
memory holds less than 32K words, reduce the CTRL Q Area. 

3.1.2 One Mode Addressing 

Users who intend to have a Bank or Page mode system only should delete 
the appropriate UFD: 



3.1.3 FORTRAN Considerations 

The user should next consider the system's FORTRAN capabilities. PDP-9 
users should call PATCH, and replace F4 supplied with the system with 
the binary file, F4X9, supplied in the PER UFD: 

$A ( ?P> <PER>-10jJ' 

'•UF> 

$PATCH J ) 

>F4j? 

> RE ADR F4X9 } 

>EXITj 
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PDP-15 users whose systems have the Floating Point Hardware should re 
place the system libraries in BNK and PAG with the libraries found in 
the extra FORTRAN Floating Point Tape. Before doing so, however, 
the system manager should consider whether FOCAL will be used at the 
installation. If so, he must make an Execute file out of FOCAL. 
(FOCAL has not been modified to take advantage of Floating Point Hard 
ware, and uses non-Floating Point OTS routines.) If the user has his 
own FOCAL routines, he should add them to FNEW (see Appendix C) . 

$PAGE ON or OFF, as desired 

$A SYS -4/ (assign desired output UIC) 

$ CHAIN 

>FOCAL ALT MODE 
>ALT MODE 

> FOCAL ALT. MODE 
>ALT MODE ALT MODE 

Then the system manager should replace the standard library with the 
Floating Point Library: 

$PIP 

>T /'<DK>'v /BNK . LIBR BIN<-DT1 BLIBRF BIN'i 
V<DP>/\.PAG .LIBR BIKH-DTl PLIBRF BIN> 

Users with PDP-15 Floating Point Hardware should then replace the 
FORTRAN supplied as a system program with the one from the Floating 
Point Tape : 

$A DTI -1) 2) 

$PATCH} 

>FA) 

> RE ADR FPF4X,? 

>EXIT ) 


3.14 Graphics 


When the proper FORTRAN routines have been installed, the user with a 
VT15 Graphics Display Processor should add the Graphics routines in 
the PER UFD to the system libraries in BNK and PAG: 

sa(^} PER -14,-15; 

$ UPDATE ) 

>usO 

>1 ROTATE J 
>1 CIRCLE V 
>1 VTPRIM? 

>1 DYLDRJ 
>1 TRACK/ 

>1 LTORPB^ 

>C) 
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3.1.5 VP15 Point Plotting Display 


The user with a VP15 Point Plotting Display should add the following 
routines to the libraries: 


$A (j£)<PER> -10/{Sp)CS?>)- 14 ' - 15 ^ 
$UPDATE^ 

>1 VECTOR^ 

>1 FORT^ 

>1 nuvalJ 

>cJ 


3.1.6 Source Files in PER 


The user should next decide whether he needs any of the source files 
supplied in PER. If so, he should assemble them via MACRO-15. 

Appendix C describes the assembly parameters relevant to all the 
source files in PER. Appendix C will also describe where in the system 
the assembled files should be inserted. 


3.1.7 Second DOSGEN Run 


The user should run through DOSGEN, to add any devices and system 
programs needed for the system. 


3.1.8 PATCH 


The user should call PATCH, to add any system programs for which 
DOSGEN has reserved space. 

3.1.9 PIP 

The user should call PIP, and transfer to IOS any handlers added to 
the system. * The user should then save the PER UFD on a tape, for 
future reference , and delete the PER UFD from the system. 


3.1.10 Copy the System 


Finally, the user should make at least one copy of the new system, 
via the DOSSAV program. 

* Once device handlers have been transferred to IOS, they must be 
renamed, if necessary, to the names assigned in Sections B and C. 
The PIP "R" command will rename files. 
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3 . 2 Using DOSGEN After the First Time 


The system manager may call DOSGEN at any time, in order to modify 
the system. Changes in system parameters, and deletion of devices, 
device handlers or system programs require no advance preparation. 
Addition of core-image system programs, however, may require some 
preliminary work with PIP. 

Core image system programs must occupy contiguous blocks on the system 
device. In a running system, it is quite possible for there to be 
sufficient free blocks to accept a new core image file, but no set of 
contiguous, free blocks. In such an instance, the user will have to 
transfer files from any of the UFD's on the system device to another 
mass storage medium, and then run DOSGEN. After the DOSGEN run, 

PATCH can add the system files, and PIP can bring back the transferred 
UFD 1 s . UFD’s need not have contiguous disk storage. 
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APPENDIX A 


DOSSAV Operating Instructions 

DOSSAV is the save/restore system for DOS-15. It resides on a paper 
tape, which must be HRM loaded at 37720 (restart 34500) . 

It saves and restores to/from DECdr sk , Disk Packs, DEC tape and Magtape. 
A DECdisk system can be saved on and restored from DECtape, Magtape 
and Disk Pack. A Disk Pack system can use DECtape and Magtape. 

Once loaded, it asks for all necessary information, such as input and 
output devices, unit numbers and, in the case of Magtape, parity and 
density . 

GENERAL INSTRUCTION: 

The user must type Carriage Return after all entries, including the 
character typed to restart after errors. 

A . Resto ring S ystems 

The following examples illustrate how to put the systems distributed 
by Digital on DECtape or Magtape onto a DECdisk or Disk Pack. The user 
responses are underlined. 

1. To restore a DECdisk system from DECtape (on Unit 1) 

DOSSAV Vnn 

INPUT DEVICE? DT ) 

UNIT NO? 1^ 

OUTPUT DEVICE? DK) 

DATE CREATED: 28-SEP-71 /Note that if DK is typed no 

/unit number is requested. 

TAPE DONE. MOUNT ANOTHER /At this point, mount tape 2 and 

/type any character on the key- 
board followed by a Carriage 
/RETURN. 


A-l 



2 . 


To restore a DECdisk system from Magtape (on Unit 0) : 


DOSSAV Vnn 
INPUT DEVICE? MTj 
UNIT NO? . 

TRACK ( 7 OR 9 ) ? 7 ) 

DENSITY (2,5,8)? 8 ) 

PARITY (E OR 0)? 03 
OUTPUT DEVICE : DKJ 
DATE CREATED: 28-SEP-71 


NOTE 

All DOS-15 System Restore Magtapes distributed 
by Digital are 800 BPI, odd parity. 


3. To restore a Disk Pack system from DECtape (on Unit 1) : 

DOSSAV Vnn 

INPUT DEVICE? DT J 

UNIT NO? 

OUTPUT DEVICE? DP ) 

UNIT NO? 1 

DATE CREATED: 28-SEP-71 

TAPE DONE, MOUNT ANOTHER At this point, mount Tape 2 and 

type any character on the tele- 
printer followed by a Carriage 
RETURN . 


4. To restore a Disk Pack: 

DOSSAV Vnn 

INPUT DEVICE? MT J 

UNIT NO? b> . 

TRACK (7 OR 9)? IP 
DENSITY (2,5,8)? 83 

PARITY ( OR O)? 0 J 

OUTPUT DEVICE? DP~> 

UNIT NO? — 

DATE CREATED: 28-SEP-71 


It is possible to restore a software system to the DECdisk which was 
created for a machine smaller (different number of DECdisk platters) 
than the one being restored to. DOSSAV does all the necessary adjust- 
ments of the SAT 1 s 1 7 Therefore, the restore tapes issued by Digital 
for a 1 platter system can be restored to any system. Note that this 
should only be done with the master tape(s) which have block 1775 g 
free. That block is needed during the restore for 5 or more DECdisk 
platters. Note that it is not possible to restore a software system 
which is larger than the hardware. (For example, one cannot restore 
a 3-platter system onto a 1-platter configuration. 

t SAT t s~: Storage Allocation Tables - i.e., bit maps. 
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Once the user has tailored the system to his specific configuration, 
he will want to save that system for future restorations. To do that, 
simply reverse the procedure above. To illustrate, consider Example 1 
above and the changes necessary to it to create a restore tape. 


To save a DECdisk system to DECtape (on Unit 1) : 

DOSSAV Vnn 
INPUT DEVICE? DK J 
OUTPUT DEVICE? DT J 
UNIT NO.? U 

TAPE DONE. MOUNT ANOTHER At this point, mount another tape 

and type any character on the key- 
board followed by a Carriage 
RETURN . 


Note that DOSSAL allows for as many DECtapes and Magtapes as are 
necessary to hold the system. 


C. Error Conditions and Messages 

Recoverable errors during command string decoding: If a question is 
answered incorrectly, DOSSAV outputs an appropriate error message and 
then repeats the question. These error messages are: 


ILLEGAL DEVICE 


BAD TRACK 
BAD DENSITY 

BAD PARITY 


An illegal device mnemonic was 
typed (something other than DP, DK, 
DT or MT) or an illegal combination 
of devices was typed (i.e., input= 
DT and output = MT) . 

Something other than 7 or 9 was 
typed. 

Something other than 2 (200) , 

5 (556 ) , or 8 (800) was typed. 

Something other than E(even) or 
0 (odd) was typed. 


Recoverable errors during operations: If it is possible to recover 
from an error, DOSSAV will attempt to do it. The error message will 
be output to the console. After the problem has been corrected, any 
character on the keyboard followed by a Carriage RETURN will resume 
operation . 

TAPE NOT READY The DECtape or Magtape unit is off 

line or not write enabled. 

DISK NOT READY DECdisk is write locked. 

DISK PACK NOT READY The Disk Pack unit is not ready. 



Unrecoverable errors: Primarily hardware errors, from which DOSSAV 
cannot recover. After the error message has been output, DOSSAV 
restarts. DOSSAV retries five times on parity error, before issuing an 
unrecoverable error message. 

DECTAPE ERROR 
MAGTAPE ERROR 
DISK ERROR 
DISK PACK ERROR 

ATTEMPT TO RESTORE SYSTEM To protect users who have access to 
TO WRONG DISK both a DECdisk and a disk pack and 

who may have several sets of 
restore tapes, all restore tapes 
are created with the mnemonic of 
the disk type in the first SAT. 
DOSSAV then checks this code against 
the output device code. If they 
differ, this message is output. 

BLK 1775 OCCUPIED. NO 2ND SAT CREATED 

A DECdisk system created for 4 or 
fewer platters is restored to a 
machine with 5 or more platters 
and block 1775 is already used. 
Therefore, no second SAT is created. 
A Master Tape was not used to make 
the restore. 


D. Tape Structure 


The restore tapes are structured as follows: The first SAT of the 
system is the first block put on the tape. This SAT, which is never 
restored to the disk, has 2 words modified: word 2 contains the 
creation date (taken from . SCOM+47) and word 376 contains the device 
mnemonic (.SIXBT, right justified). All the occupied blocks referenced 
by this SAT are then put sequentially on the tape. The second SAT, if 
there is one, is then put on, and so on. This structure enables use of 
Magtape, which is a sequential only device. 


E. DOSSAV Restrictions 


1. It is not possible to save or restore Magtapes with even 
parity . 

2. DOSSAV fails when two DECtapes are on line with the same 
unit number. It is necessary to restart under such 
circumstances . 

3. Error checking and recovery is minimal. 
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APPENDIX B 


Ib-UCT-71 


DIRECTORY LISTING 


2*5 1 2 

FREE 

BtKb 

b 

USER 

FILtS 

low 

USER 

BLKS 

EXECUT 

BIN 

3 

.LltsR 

BIN 

106 

.LOAD 

BIN 

11 

FOCAL 

BIN 

23 

DOT 

BIN 

13 


(BNK) 


24-SEP-71 
24-SEP-71 
i4b-t)CT-7l 
24-SEP-71 
24-SEP”7 1 


15-0CT-71 


OIRtCTORV LISTING 


2(412 

FREE 

BLKS 

b 

USER 

F iLES 

1 Ol4 

UfctR 

BUKS 

EXECUT 

BIN 

3 

,LIdR 

BIN 

106 

.LOAD 

BIN 

1 1 

FUCAL 

BIN 

23 

DOT 

BIN 

13 


CPAG) 


24-SEP-71 
24-SEP-71 
W6-0CT-71 
24-SEP-7 1 
24-SEP-71 


1 5-0CT-7 1 

MFC DIRECTORY LISTING 
2(412 FREE bLKS 


Ob USER FILES 
1 tfl04 USER OLKS 


BNK 

S4cn 

5 

160 

PAG 

jn2cn 

5 

160 

IDS 

277 Cl) 

31 

221 

SCR 

N 0 N ( id ) 

4 

M 

PEP 

53 C 1 ) 

21 

271 
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APPENDIX C 


The following is a listing of the PER UFD: 


2Hm$EPm7\ 


DIRECTORY LISTING (PER} 


15 

FREE 

BLKS 


21 

USER 

files 


271 

USER 

BLKS 


OQSBCD 


37 

28. SEP-71 

CD. DOS 

P12 

52 

28-SEP-71 

FNEW 

00 4 

16 

28-SEP-71 

LPA.15 

042 

31 

28-SEP-71 

ovldr 

BIN 

2 

28-SEP-7 1 

TRACK 

BIN 

2 

28-SEP-7 1 

VTPRIM 

BIN 

7 

28-SEP-71 

ROTATE 

BIN 

2 

28-SEP-71 

Nil V AL 

BIN 

1 

28-SEP-71 

FORT 

BIN 

1 

28-SEP-71 

VECTOR 

BIN 

3 

28- SEP-71 

CIRCLE 

BIN 

2 

28-SEP-7 1 

LPA.09 

BIN 

3 

28-SEP-71 

F4K9 

BIN 

52 

28-SEP-71 

VPA.S 

BIN 

4 

28. SEP-71 

LP • 647 

BIN 

3 

28-SEP-7 1 

LTORPR 

BIN 

1 

2S-SEP-71 


PER contains four source files: 


DOSBCD 003 
CD. DOS 004 
FNEW 004 
LPA.15 042 

Those installations which have their own FOCAL routines may want to 
use EDIT's GET command to add their sources for FNEW. If these 
sources substitute for others already present, EDIT can delete the 
old routines. Once FNEW is completed, MACRO will produce FNEW BIN. 
Then, the following commands to UPDATE will delete the old FNEW, and 
insert the new one: 
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Table C-l, Assembly Parameters for Handler Sources in PER UFD, shows 
the assembly parameters that will produce all the possible variations 
of binary files. Note that once assembled, programs put in the IOS 
UFD must be renamed. For example, the binary produced from assembling 
LPA.15 042 is LPS.15 BIN. When this program is put in the IOS UFD, it 
must be renamed to LPA . BIN. 

TABLE C-l 

ASSEMBLY PARAMETERS 


Binary Produced 

Source 

Name 

Assembly Parameters 

LPA. 

(form feed on 




. INIT 

's, . CLOSES 's 




& every 57 1Q lines) 

LPA.15 

042 

none 

LPA. 

(form feed on 




.INIT 

& every 57.^ lines) 

LPA.15 

042 

NOFF=l 

LPA. 

(tab stop=8) 

LP.647 

002 

none 

LPA. 

(tab stop=10) 

LP.647 

002 

TAB 10=0 

CDB . 

(CR03B, 029 mode) 

CD. DOS 

012 

none 

CDB. 

(CRO3B,026 mode) 

CD. DOS 

012 

DEC026=0 

CDB. 

(CR15,029 mode) 

CD. DOS 

012 

CR15=0 

CDB. 

(CR15,026 mode) 

CD. DOS 

012 

CR15=0 





DEC026=0 

CDB. 

(CROlE , CR02B , 





029 mode) 

CD. DOS 

012 

NOTGDI=0 

CDB. 

(CROlE, CR02B, 

CD. DOS 

012 

NOTGDI=0 


026 mode) 



DEC026=0 

BCDB . 

(CR03B ,029 mode) 

DOSBCD 

003 

none 

BCDB . 

(CR03B ,026 mode) 

DOSBCD 

003 

DEC026=0 

BCDB. 

(CR01E ,CR02B, 

DOSBCD 

003 

NOTGDY=0 


029 mode) 




BCDB. 

(CR01E , CR0 2B , 

DOSBCD 

003 

NOTGDI=0 


026 mode) 



DEC026=0 

Any number of positive .DAT 

slots over 20 g requires reassembly of 


FIOPS and . FLTB . These sources may be purchased from Digital 


Equipment Corporation under the following order number: 
DEC-15-SRDA-U11. Assembly parameter for .FLTB is: FLTBSZ=n< 77 g . 
Assembly parameter for FIOPS is: STTBSZ=n< 77 g . 
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APPENDIX D 


SYSBLK 010 SYSBLK D0S15 

, TITLE SYSBlK D0S15 

/ 

/COPYRIGHT 1971, DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS, 

/ 

/EDIT #010 9-22-71 

/ 

/ SYSBLK (SYSTEM BLOCKS #34 AND 35(8)) CONTAINS THE PARAMETERS FOR 

/LOADING ALL THE COKE IMaGE FILES (SYS FILES) ON THE D0Si5 
/SYSTEM EXCEPT FOR ThE DATA FILES SGNBLK(#36> 

/AND SYSBLK, SYSBLK IS PART OF THE SYSTEM LOADER AND NON-RESIDENT MONITOR AND 
/STARTS AT LOCATION 16100(8), THE ORDER OF ENTRIES IN SySBLK IS 
/UNIMPORTANT EXCEPT FOR THE FIRST i PERMANENT ENTRIES, THIS TABLE IS USED BY 
/PATCH, SGENi THE SYSTEM LOADER, AND THE NON-RESIDENT MONITOR. 

/THIS TABLE IS MODIFIED WHEN 

/NECESSARY BY SGEN And Patch, the FIRST WORD OF SYSBLK CONTAINS 
/THE UNRELOCATEO ADORESS OF THE FIRST FreE WQRLj OF SYSBLK, THE 
/ENTRIES CONSIST OF 7 WORDS, THE FOLLOWING 
/DESCRIPTION APPLIES TO ALL 7 WORD ENTRIES) 

/ WD1 , WD2 , S I X 8 T 'NAME* 

/ WD3 FIRST BLOCK # ( F B > 

/ WD4 # OF BLOCKS OCCUPIED < NB ) 

/ WD5 FIRST ADORESS (FA) (13 BITS) 

/ WD6 PROGRAM S 1 2 E (PS) (HIGHEST ADDRESS - FA + 1) 

/ WD7 START ADDRESS < S A ) ( 1 3 BITS) 

/ 

.ABS 

00000 , LOC 3 

0000G 300242 SYSBLK END /POINTER TO FIRST FREE WORD OF SYSBLK 

.EJECT 



SYSBL.K 010 


SYS8LK D0S15 


/ 

/ THE FOLLOWING THREE ENTRIES ARE FIXED IN SYSBLK AND CAN NEVER 

/BE deleted, they represent the basic SYS FILE CUSPS TO RUN the 
/SYSTEM AND THE CONTROL Q AREA, 


/ 


00001 

220523 

SE1 

» S 1 XBT 

'RESmON' 

00002 

151716 




00003 

000000 


0 


00004 

000040 


40 


00005 

000100 


100 


00006 

P17400 


17400 


00007 

000000 


0 


00013 

562331 

SE2 

, S I XBT 

’ .SYSLD’ 

00011 

231404 




00012 

000040 


40 


00013 

000013 


13 


00014 

011000 


11000 


00015 

005100 


5100 


00016 

011003 


11000 


00017 

362101 

SE3 

, S I XBT 

' t QARE A * 

00020 

223501 


, ifund 

RP00 

00021 

000101 


101 
, ENDC 

, ifdef 
117030 
,ENDC 

RP02 

00022 

000200 


200 


00023 

000005 


5 


00024 

<377 7 73 


77773 


0002.5 

000000 


0 



• EJECT 



/ THIS ENTRY BEGINS THE DELETEABUE CORE IMAGE CUSPS 


/ 


00K26 

050411 

SE5 

,SI XBT 

'EDIT' 

00027 

240003 




00030 

000317 


317 


00031 

000015 


15 


00032 

311135 


11135 


00033 

006007 


6007 


00034 

011404 

y 

11404 


00035 

0504H 

SE6 

, S I XBT 

' ED I T VP 

00036 

242620 




00037 

000334 


334 


30040 

000017 


17 


00041 

010121 


10121 


00042 

306755 


6755 

* 

00043 

310402 


10402 


00044 

3504H 

SE7 

, S I XBT 

'EDITVT 

00045 

242624 




00046 

000353 


353 


00047 

000017 


17 


00050 

010130 


10130 


00051 

306773 


6773 


00052 

010406 


10406 


00053 

201120 

SE10 

i S I XBT 

'PlPp' 

00054 

000000 




00055 

000372 


372 


00056 

000035 


35 


00057 

001343 


1343 


00060 

016274 


16274 


00061 

001506 


1506 


00062 

210611 

SE11 

, S I XBT 

'QFI|_E' 

00063 

140500 




0006 4 

000427 


427 


00065 

000002 


2 


00066 

017041 


17041 


00067 

000437 


437 


00070 

317045 


17045 


00071 

150103 

SE12 

• S I XBT 

'MACRO' 

00072 

221700 




00073 

000431 


431 


00074 

000033 


33 


00075 

002630 


2630 


00076 

015005 


15005 


00077 

002630 


2630 




003 0!? 
00101 

'1322 c-5 
063003 

SE 13 

.SIXBT 

00102 

300464 


464 

00103 

('■00005 


5 

0 010 4 

"■15550 


15550 

00105 

002007 


2007 

00106 

015551 

/ 

SE14 

15551 

00107 

00110 

031001 

11163? 

.SIXBT 

00111 

000471 


471 

00112 

000021 


21 

00113 

307240 


7240 

00114 

013377 


10377 

00115 

007240 

/ 

3E15 

7240 

00116 

00117 

066403 

000000 

.SIXBT 

00120 

000512 


512 

00121 

000035 


35 

00122 

002061 


2061 

00123 

'’115556 


15556 

00124 

302206 

/ 

SE16 

2206 

00125 

00126 

042515 

230000 

.SIXBT 

00127 

000547 


547 

00130 

000005 


5 

00131 

015330 


15300 

00132 

302337 


2337 

00133 

315300 


15300 

00134 

00135 

042403 

172031 

y 

SE17 

.SIXBT 

00136 

000554 


554 

00137 

000003 


3 

0014P 

316662 


16662 

00141 

303755 


755 

00142 

316701 


16701 

00143 

00144 

200124 

031000 

SE20 

.SIXBT 

00145 

000557 


557 

00146 

000010 


10 

00147 

012700 


12700 

00150 

003463 


3463 

00151 

012700 


12700 

.EJECT 


' cref ' 


’CHAIN' 


*F4P«i ' 


' DUMP l 


' OTCqPY ' 


'PATCH' 



2 ) 2 ) 15 ? 

? ? 2 *:■ e a 

SE21 

e S I XBT 

2)0156 

312405 



00154 

000567 


567 

00155 

000013 


13 

00156 

012370 


12370 

00157 

005247 


5247 

00160 

012371 

/ 

SE22 

12371 

00161 

232203 

. S I XBT 

00162 

031715 



00163 

000602 


602 

0016 4 

000013 


13 

00165 

012647 


12647 

00166 

004770 


4770 

00167 

012752 


12752 

00170 

702422 

SE23 

, S I XB T 

00171 

011600 



00172 

000615 


615 

00173 

000011 


11 

00174 

013607 


13607 

00175 

004030 


4030 

00176 

313671 


13671 

00177 

707124 

SE24 

« S ! XBT 

00200 

220116 



00201 

000626 


626 

00202 

000011 


11 

00203 

013562 


13562 

00204 

004055 


4055 

00205 

013644 


13644 

00206 

152404 

SE25 

■ S I XBT 

00207 

251520 



00210 

000637 


637 

00211 

000012 


12 

00212 

013167 


13167 

00213 

004453 


4450 

00214 

013263 

/ 

SE26 

13260 

00215 

230705 

i S I XBT 

00216 

160000 



00217 

300651 


651 

00220 

000022 


22 

00221 

005545 


5545 

00222 

010356 


10356 

00223 

005613 


5610 

00224 

241302 

SE27 

,S JXBT 

00225 

000030 




'UPUATE ' 


'SRCCOM' 


' 8TH AN ' 


'89TRANI 


'MT0UMP' 


'SGEN' 


' T K Bg» » 



00226 

000706 


706 

00227 

000021 


21 

00230 

007573 


7573 

00231 

010044 


10044 

00232 

007750 


7750 

00233 

00234 

041723 

616500 

SE30 

, S I XBT 

00235 

000727 


727 

00236 

000035 


35 

00237 

000677 


677 

00240 

015201 


15201 

00241 

001276 

000242 

END=, 

1276 


'DOSlS» 



.TITLE COMBlK 00S15 


00600 

00600 

00601 

00602 

00603 

00604 


000005 

041723 

616500 

000001 

000766 


/ 

/ 

/ COMBLK CONTAINS INFORMATION THE SYSTEM LOADER. THE 

/non-resident monitor, and system generator need TO REMEMBER 
/ABOUT CURRENT SYS FILE CUSPS, 

/the last location in sysblk contains the 

/UNRELOCATED ADDRESS OF the FIRST ENTRY in COMBLK. THE 
/REMAINDER OF COMBLK CONSISTS OF VARIABLE LENGTH ENTRIES 
/WITH SYS FILE CUSPS (COrE IMAGE SYSTEM PROGRAM FILES), 

/ENTRY IS OF THE FOLLOWING FORM! 

/ <1> THE FIRST WORD IS AN OFFSET NUMBER INDICATING THE 

/ NUMBER OF WORDS IN THE ENTRY INCLUDING THE OFFSET 

/ WORD. 

/ (2) THE NEXT TWO WORDS CONTAIN THE NAME OF THE CUSP IN 

/ if the name is less than six characters in length, 

/ TRAILING CHARACTER POSITIONS are ZEROED , THE FIRST 

/ CHARACTER POSITION MUST BE NON-2ERO, 

/ (3) IF THERE ARE ANY OVERLAY SEGMENTS, THEIR TWO WORD NAMES 

/ ARE ENTERED AFTER THE FIRST NAME ABOVE (2), 

/ (4) WHEN A WORD HAS 0»S IN BIT POSITIONS 0-5, AND IT 

/ IS RIGHT AFTER THE CUSP NAME OR aN OVERLAY NAME, 

/ IT TERMINATES THE LIST OF SEGMENT NAMES, THE 

/ OF THIS WORD CONTAINS THE DEFAULT VALUE FOR 

/ COMMAND FOR the CUSP, 

/ (5) THE REMAINDER OF THE COMBLK ENTRY CONTAINS THE ACTIVE 

/ .DAT SLOT NUMBERS FOR THE CUSP WITH BITS 0-8 2ER0EQ 

/ (EXCEPT THAT -X INDICATES ThaT ALL POSITIVE .DAT SLOTS 

/ ARE TO Be LOADED) , 


ASSOCIATED 

EACH 


, S I XBT 
THE 


REMAINDER 
THE 'FILES' 


/ 

/THE SYSTEM 
/FIRST ENTRY 


GENERATOR ADDS 
, IN THIS WaY 


CUSPS TO COMBLK by MAKING THEM THE NEW 
SYSBLK AND COMBLK BUILD TOWARD THE CENTER, 


iLOC 


600 


El 


E3-E1 
, S I XBT 


'D0Si5» 


-124777 

.EJECT 



00605 000007 

00606 050411 

00607 240000 
00610 000002 

00611 000763 

00612 000764 

00613 000770 

00614 000010 

00615 050411 

00616 242620 

00617 000002 

00620 000763 

00621 000764 

00622 000770 

00623 000010 

00624 000007 

00625 0504H 

00626 242624 

D 00627 000002 

i 00630 000763 

00631 000764 

00632 000770 

00633 000005 

00634 201120 

00635 000000 

00636 000004 

00637 777777 

00640 000013 

00641 150103 

00642 221700 

00643 032205 

00644 060000 

00645 000003 

00646 000764 

00647 000765 

00650 000766 

00651 000767 

00652 000770 


E3 


E4-E3 

, S I XBT 'EDIT' 


/# OF buffers req FOR EDIT, 


2 

"194777 
-144777 
"104777 

/ 

E4 E4A"E4 

.SIXBT * ED I TVP » 

2 /# or buffers req for eoitvp. 

"154777 

-144777 

-104777 

10 

/ 

E4A E5", 

, S 1 XBT 'EDITVT* 

2 

"154777 

*144777 

*104777 

/ 

E5 E6-E5 

i S I XBT 'PJPf 

4 /# OF BUFFERS REQ FOR PIP, 

-1 /ALL POSITIVE .DAT SLOTS 

/ 

E6 E7-E6 

,SIXBT 'MACRO' 

, S I XBT 'CREF* 

3 

*144777 

-134777 

*124777 

*114777 

-104777 



00653 

00654 

00655 

00656 

00657 
00660 
00661 
00662 

00663 

00664 

00665 

00666 
00667 

00670 

00671 

00672 

00673 

00674 

00675 

o 00676 

00677 

00700 

00701 

00702 

00703 

00704 

00705 

00706 

00707 

00710 

00711 

00712 

00713 


000010 

E7 

E8-E7 

031001 


,S!XBT 

111600 

000003 


3 

000772 


~64777 

000773 


-54777 

000774 


-44777 

000777 


-14777 

000007 

E8 

E9-E8 

066400 


» S I XBT 

000000 

000003 


3 

000765 


"134777 

000766 


"124777 

000767 

y 

-114777 

000006 

/ 

E9 

E10-E9 

042515 


i S I XBT 

200000 

000002 


2 

000764 


-144777 

000766 

/ 

E10 

-124777 

000006 

E11-E10 

042403 


i S I XBT 

172031 

000002 


2 

000763 


-154777 

000764 


-144777 

000006 

Ell 

E12-E11 

200124 


i S I XBT 

031000 

000002 


2 

000764 


-144777 

000770 


-104777 


'CHAIN* 


t F 46»e* » 


• DUMp » 


•DTCOPY' 


•PATCH* 



01 - 


00714 

00713 

00716 

00717 

00720 

00721 

00722 

00723 

00724 

00725 

00726 

00727 

00730 

00731 

00732 

00733 

00734 

00735 

o 00736 

00737 

00740 

00741 

00742 

00743 

00744 
00743 

00746 

00747 

00750 

00751 

00752 

00753 

00754 

00755 

00756 

00757 

00760 

00761 


000010 

£12 

E13-E12 


252004 


.SIXBT 

MJPUATE* 

012405 




000004 


4 


000763 


*154777 


000764 


*144777 


000766 


*124777 


000770 


*104777 


000007 

E13 

E13A*E!3 


232203 


.SIXBT 

'SRCCOM' 

031715 




000003 


3 


000763 


*154777 


000764 


*144777 


000766 


*124777 


000006 

E13A 

E13B-, 


702422 


.SIXBT 

'8TRAN* 

011600 




000002 


2 


000763 


*154777 


000764 


*144777 


000006 

E13B 

E13C*, 


707124 


.SIXBT 

' 89TRAN ' 

220116 




000002 


2 


000763 


*134777 


000764 


-144777 


000006 

E13C 

E13D-, 


152404 


.SIXBT 

•MTDUMP' 

251520 




000002 


2 


000001 


1 


000003 


3 


000005 

E13D 

E14* , 


210611 


.SIXBT 

» QF I LE » 

140500 




000001 


1 


000764 


-144777 
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00762 

000005 

EH 

E15-E14 


00763 

230705 


• S I XBT 

»SGEn» 

00764 

160000 




00765 

000001 


1 


00766 

000764 


"144777 


00767 

000010 

E15 

E16" , 


00770 

241302 


i S I XBT 


00771 

000000 




00772 

000003 


3 


00773 

000772 


-64777 


00774 

000773 


-54777 


00775 

000774 


"44777 


00776 

000777 


"14777 



000777 

E16* . 



00777 

000600 

comblk 

El 

/POINTER TO THE FIRST ENTRY IN COMBLK 


000000 


.END 



SIZE 

*01000 

NO ERROR 

LINES 
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00000 

00000 


.TITLE SGNBLK D0S15 

/ 

/COPYRIGHT 1971. DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS, 

/ 

/EDIT #008 9-82-71 

/ 

/ SGNBLK (SYSTEM BLOCK #36(8)) CONTAINS ALL THE SYSTEM PARAMETERS 

/NOT ASSOCIATED DJREcTLY WITH SYS FILE CUSPS. THE BULK OF SGNBLK 
/IS CONCERNED WITH I/O (.DAT SLOTS • , UFD SLOTS, SKIP CHAIN ORDER, HANDLERS, 
/SKIP I OT NUMBERS AND MNEMONICS), THE FIRST FEW REGISTERS OF SGNBLK 
/HOLD SUCH IMPORTANT SYSTEM PARAMETERS AS THE SYSTEM DEVICE, 

/ , SCOM*A CONTENTS, ETC, 9GNBLK IS PART OF THE 

/SYSTEM LOADER AND NON-RESIDENT MONITOR AND STARTS AT LOCATION 

/17100 ( 8 ) i THE FIRST 

/WORD IN SGNBLK POINTS TO THE UNRELOCATED ADDRESS OF THE FIRST FREE 
/WORD IN THE BLOCK, THE NEXT ENTRY IS AN OFFSET WORD INDICATING 
/THE TOTAL LENGTH (INCLUDING ITSELF) OF THE MISCELLANEOUS 
/SYSTEM PARAMETER TABLE fO FOLLOW, THIS TABLE INCLUDES THE SI2E OF 
/THE , OAT Slot TABLE and THE SIZE OF the Skip CHAIN TABLE, THE END 
/or the hanoler ano skip iot table is the first free entry of the block, 

/ 

,ABS 

i ICC 0 

000313 SGNBLK .SIZE /POINTER TO FIRST FREE ENTRY IN SGNBLK 



SGNBLK 008 


SGnBLK D0S15 


,1FDEF RP02 
SYS0EV«17 

.ENDC 

, i fund rp02 

000014 SYSDEVaI.4 

, ENDC 

/ 

/BASIC SYSTEM PARAMETERS 


/ 


00001 

000015 

nopar 

sgndat- 

• 

/NUMBER OF MISCELLANEOUS PARAMETERS 

00002 

000074 

NODAT 

SGNSKP- 

SGNDAT 

/(NUMBER OF POSITIVE ,DAT SLOTS * 16)*2 
/EQUALS S 1 2 E OF .DAT SLOT TABLE AND ,UFD TABLE 

00003 

000026 

NOSKP 

SGNTAB" 

SGNSKp 

/NUMBER OF SKIPS IN THE SKIP CHAIN 


000004 

S 0 E V 1 * , 

, ifdef 

fi P0* 

/SYSTEM OEVICE CODE 




.sixbt 

.ENDC 

/DP/ 





, i fund 

RP02 


00004 

041300 


.sixbt 

, ENDC 

/DK/ 


00005 

300500 

SC0M4 

300500 


/ORIGINAL CONTENTS OF .SCOM+4 

0 0006 

000000 

SCOM20 

0 


/ORIGINAL CONTENTS OF .SCOM+20 

00007 

000500 

XI 

500 


/NUMBER OF DATA REGISTERS PER OPEN FILE ON MASS 
/STORAGE ( i SCOM + 2 7 ) 

00010 

000003 

FILES 

3 


/DEFAULT NUMBER OF FILES TO BE OPEN AT SAME TIME t.SCOM+26) 
/FOR USE WITH The LINKING LOADER AND EXECUTE 

00011 

233123 

MIC 

.SlXBT 

' SYS * 

/t h e monitor identification code 

00012 

000000 

SC0M33 

0 


/»x INFORMATION (,SC0M*33) 

00013 

000002 

PROTCT 

2 


/DEFAULT PROTECTION CODE FOR FILES (.SCOM+54) 

/ 1 READ/WRITE (WITH RANDOM ACCESS) 

/ 2 READ/NQ WRITE 

/ 3 NO READ/NO WRITE 

00014 

000000 

PCHSZ 

0 


/SIZE OF THE RESIDENT MONITOR PATCH AREA 

00015 

777704 

CLKCON 

•>74 


/-# OF TICKS IN a SECOND ("74 FOR 


/60 CPS AND -62 TOR 50 CPS) 
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.TITLE .oat slots table 

/ 

/ THIS .OAT SLOT TABLE CORRESPONDS TO THE LEGAL RANGE 

/OF .DAT SLOTS WITH THE MAXIMUM NEGATIVE ,OAT SLOT SET To -15 AND 
/THE MAXIMUM POSITIVE ,DaT SLOT SET TO A SYSTEM PARAMETER NOT TO 
/EXCEED 77(8), THE .DAT SLOTS ARE IN The SAME FORM AS BEFORE. THE 
/UNIT NUMBER IS IN BITS 0-2 AND THE NUMBE* OF THE HANDLER RIGHT 
/JUSTIFIED IN BITS 3-16, THE HANDLER NUMBER FOR THE FIRST HANDLER IN 
/THE DEVICE HANDLER"SK I P IDT TABLE IS 0 (For THE PSEUDO-HANDLER NON). 
/TTA IS 1 ETC, THE CONSTANT 100000 INDICATES A FIXED OR ILLEGAL 
/.OAT SLOT, THESE SLOTS aRE NOT SET BY SGEN, 


/ 


00016 

000014 

sgndat sysoev 

/-15 

00017 

000014 

SYSDEV 

/"14 

00020 

000014 

SYSOEV 

/-13 

00021 

000001 

1 

/-12 

03022 

000014 

SYSDEV 

/"ll 

00023 

000001 

1 

/-10 

00024 

100003 

100000 

/-7 

00025 

000014 

SYSDEV 

/-6 

00026 

000003 

0 

/»5 

00027 

000014 

SYSDEV 

/" 4 

00030 

100000 

100000 

/a3 

00031 

100000 

100000 

/- 2 

00032 

000014 

SYSDEV 

/■I 

00033 

100000 

100000 

/0 

00034 

000014 

SYSDEV 

/I 

00035 

000014 

SYSDEV 

/2 

00036 

000014 

SYSDEV 

/3 

00037 

300001 

1 

/4 

00040 

000002 

2 

/5 

00041 

000004 

4 

/6 

00042 

100007 

100007 

/7 

00043 

200007 

200007 

/10 

00044 

000000 

0 

/U 

00045 

000000 

0 

/12 

00046 

303000 

0 

/13 

00047 

000003 

0 

/14 

00050 

000300 

0 

/15 

00051 

000000 

0 

/16 

00052 

000000 

0 

/17 

00053 

000000 

0 

/20 
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title ,ufu table 


/ 

/ ,ufd table is IN 1 TO 1 CORRESPONDENCE with the ,dat slot 

/TABLE. AN entry of , S I xBT * U I C * INOICatES that the login 
/Ulc IS TO BE SUBSTITUTED FOR THE Name UlC IN THE TABLE, OTHERWISE 
/THE CONTENTS OF EACH LOCATION WILL BE THE .SIXBT REPRESENTATION OF 
/THE CORRESPONDING .UFD SLOT. 


/ 


00054 

251103 

SGNUFQ .SIXBT 

’UIC' 

/-15 

00055 

251103 

.SIXBT 

* U I C * 

/ •» 14 

00056 

251103 

.SIXBT 

♦UIC* 

/-13 

00057 

251103 

.SIXBT 

♦UIC* 

/■12 

00060 

251103 

.SIXBT 

'UIC' 

/- 11 

00061 

251103 

.SIXBT 

'UIC* 

/-10 

00062 

233123 

.SIXBT 

'SYS' 

/»7 

00063 

251103 

.SIXBT 

'UIC' 

/-6 

00064 

251103 

.SIXBT 

'UIC» 

/-5 

00065 

251103 

.SIXBT 

'UIC' 

/<• A 

00066 

251103 

.SIXBT 

'UIC' 

/»3 

00067 

251103 

.SIXBT 

'UIC' 

/ «* 2 

00070 

233123 

, SJXBT 

'SYS' 

/ * 1 

00071 

233123 

.SIXBT 

'SYS' 

/0 MIC 

00072 

251103 

.SIXBT 

'UIC* 

/I 

00073 

251103 

.SIXBT 

'UIC' 

/2 

00074 

251103 

.SIXBT 

'UIC' 

/3 

00075 

251103 

.SJXBT 

'UIC' 

/ 4 

00076 

251103 

.SIXBT 

'UIC' 

/5 

00077 

251103 

.SJXBT 

'UIC* 

/ 6 

00100 

251103 

.SJXBT 

•UIC* 

n 

00101 

251103 

.SJXBT 

'UIC' 

/10 

00102 

251103 

.SJXBT 

'UIC' 

/ii 

00103 

251103 

.SIXBT 

'UIC' 

/12 

00104 

251103 

.SIXBT 

'UIC' 

/ii 

00105 

251103 

.SJXBT 

'UIC' 

/l< 

00106 

251103 

.SIXBT 

'UIC' 

/12 

00107 

251103 

.SIXBT 

'UIC' 

/l 6 

00110 

251103 

.SIXBT 

'UIC* 

/V 

00111 

251103 

.SJXBT 

'UIC' 

/2K> 
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TITLE SKIP CHAIN table 


/ 

/ THE SKIP CHAIN TABLE LISTS THE SYSTEM SKIP IOTS IN ORDER 

/ A NEGATIVE SKIP APPEARS IN THE T ABLE I li l'S COMPLEMENT ( PUS I T I VE > , 

/ 1 1 0 T ALL THE SKIPS IN THk HANDLER-SKIP inT TaBLE NEED TO RE INCLUDED IN 
/ r H I S TABLE, THE CONE COMMAND IN SGEN CAN BE USED TO TERMINATE 
/THE SKIP CHAIN BUILDING AT ANY SI*E, THIS EFFECTIVELY DELETES THE 
/REM A I N I NG » UNLISTED SKIpS FROM THE SKIP CHAIN, 


/ 


00112 

703201 

SGNSkP 703201 

/SPFAL 

00113 

707601 

707601 

/DTDF 



, I FUND 

RB0V 

00114 

707001 

707001 

/DSSF 



.ENOC 




. ifdef 

RB0V 



707121 

/dssf 



,endc 


00115 

706341 

706341 

/DPS j 

00116 

707341 

707341 

/MTSF 

00117 

703121 

703121 

/SPD I 

00120 

703261 

703261 

/WTSK 

00121 

700921 

700521 

/SOOF 

00122 

706701 

704701 

/RCSF 

00123 

706721 

706721 

/RCSD 

00124 

706501 

706501 

/LSOF 

00125 

700001 

700001 

/CLSF 

00126 

700101 

700101 

/RSF 

00127 

700201 

700201 

/PSF 

00130 

700301 

700301 

/KSF 

00131 

704101 

704101 

/SPKF 

00132 

700401 

700401 

/ T S F 

00133 

707561 

707561 

/DTEF 

00134 

706361 

706361 

/DPSE 

00135 

701741 

701741 

/MPSnE 

00136 

701701 

701701 

/MPSk 

00137 

702701 

702701 

/SPE 
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00140 

00141 

00142 

00143 

00144 

00145 

00146 

00147 

00150 

00151 

00152 


.title device handler-skip 

/ 

/ THE DEVICE HaNDLER-SKIP IOT 

/and skip iot numbers and mnemonics 
/system, every device has an entry 
/name must be exactly 3 characters 


IOT TABLE 

TABLE CONTAINS ALL THE HANDLER NAMES 
EQR EACH I/O DEVICE KNOWN TO THE 
IN THE TABLE, A HANDLER 
IN LENGTH WITH THE LAST CHARACTER 
/NOT AN OCTAL DIGIT, THE DEVICE CODE FOR A DEVICE IS EXACTLY 2 
/CHARACTERS, THE FIRST 2 CHARACTERS OF EACH HANDLER NAME FOR A 
/DEVICE MUST BE THE DEVICE CODE, THIS FACT IS ESSENTIAL FOR UNDERSTAND- 
ING The format of a DEVICE ENTRY, SINCE The device code is never 
/STORED AS SUCH IN An ENTRY, BUT IS INFERRED FROM THE DEVICE HANDLER 
/NAMES, THE TYPICAL ENTRY FOR A DEVICE IS THE FOLLOWING: 

/ m THE FIRST WORDS OF AN ENTRY CONTAIN THE HANDLER NAMES 

/ FOR A DEVICE IN , SIXBT: EACH HANDLER NAME IS DIFFERENT, 

/ A 3 CHARACTER HANDLER NAME IN ,S[XBT NEATLY FITS INTO 

/ i computer word, the end of the list is determined 

/ BY A WORD WITH 0'S IN BITS 0-5 (FIRST CHARACTER POSITION). 

/ (2) THE WORD THAt TERMINATED (1) CONTAINS THE NUMBER OF SKIP 

/ I OTS FOR THE DEVICE, FOR EACH SKIP IOT 3 WORDS ARE IN THE 

/ TABLE, THE FOLLOWING IS A REPRESENTATION OF THESE 3 WORDS! 

/ (A) THE FIRST 2 WORDS Are THE SKIP MNEMONIC USED FOR 

/ REFERRING TO THE SKIP SYMBOLICI.Y IN .SIXBT WITH 

/ TRAILING CHARACTER POSITIONS CONTAINING 0'S, THF 

/ SKIP MNEMONIC MUST NOT EXCEED 6 CHARACTERS, 

/ (B) THE LAST WORD ABOUT THE SKIP IS THE ACTUAL MACHINE 

/ INSTRUCTION NU m BER FqR THE SKIP IOT, IF THE 

/ SKIP IS NEGATIVE THIS NUMBER WILL BE l'S COMPLEMENT 

/ of the actual machine instruction (positive), 

/THE NEXT DEVICE ENTRY FOLLOWS THE LAST SKIP FOR THE PREVIOUS DEVICE. 

/a handler may be entered without any skips, but no devices may be 

/ENTERED WITHOUT AT LEAST ONE HANDLER NAmE, 

/ 


161716 

SGNTAB , SIXBT 

' NON ' 

/DEV 0 HAND, 0 

000005 

5 


/5 SKIPS 

031423 

060000 

.SIXBT 

' C L S F * 

/CLOCK DONE 

700001 

700001 



152023 

160500 

•SIXBT 

'MPSnE' 

/non-existent memory reference 

701741 

701741 



152023 

130000 

.SIXBT 

'MPSk* 

/MEMORY PROTECT VIOLATION 

701701 

701701 





00153 

232005 


« S J XBT 

•SPE.** 

'MEMORY PARITY ERROR 

00154 

000000 





00155 

702701 


702701 



00156 

232006 


■ S I XBT 

•SPEAL' 

/POWER FAIL 

00157 

011400 





00160 

703201 


703201 



00161 

242401 

DEVI 

i 8 I XBT 

' TT A i 

/DEVI HanD.I 

00162 

000002 


2 


/2 SKIPS 

00163 

132306 


• S J XBT 

'K$F>t 

/KEYBOARD done 

00164 

000000 





00165 

700301 


700301 



00166 

242306 


i S I XBT 

' TSF>« 

/TELEPRINTER done 

00167 

000000 





00170 

700401 


700401 



00171 

202201 

DEV2 

■ S I XBT 

»PRA* 

/dev2 hand , 2 

00172 

202202 


■ S I XBT 

* PRB i 

/HAND, 3 

00173 

000001 


1 


/I SKIP 

00174 

222306 


i S J XBT 

•RSFpt 

/reader DONE 

00173 

000000 





00176 

700101 


700101 



00177 

202001 

DEV3 

■ S I XBT 

t PPA ' 

/HAND, 4 

00200 

202002 


i S J XBT 

i ppB ' 

/HAN0.5 

00201 

202003 


i S I XBT 

• PPCi 

/HAND, 6 

00202 

000001 


1 


/I SKIP 

00203 

202306 


i S I XBT 

•PSfP' 

/PUNCH DONE 

00204 

000000 





00203 

700201 


700201 



00206 

042401 

DEV4 

• S I XBT 

iQTA' 

/HAN0.7 

00207 

042403 


i S I XBT 

' DTC • 

/HAND, 10 

00210 

042404 


, S I XBT 

' DTD » 

/hand, u 

00211 

042405 


, SI XBT 

’DTE* 

/HAND, 12 

00212 

042406 


i S I XBT 

'DTE* 

/HAND, 13 

00213 

000002 


2 



00214 

042404 


i S J XBT 

*DTDF' 

/dectape done 

00215 

060000 





00216 

707601 


707601 



00217 

042405 


a S I XBT 

•QTEE' 

/DECTAPE ERROR 

00220 

060000 





00221 

707561 


707561 





00222 

041301 

DEV5 

.SIXBT 

•OKA* 

/HAND, 14 

00223 

041302 


• 3 1 XBT 

•OKB' 

/HAND,15 

00224 

041303 


, S I XBT 

'DKC* 

/HAND, 16 

00225 

000001 


1 


/l SKIP 

00226 

042323 


i S I XBT 

• DSSF ' 

/disk done 

00227 

060000 








, lEUND 

RB0V 


00230 

707001 


707001 






i ENOC 






, ifdef 

RB0V 





707121 






• CNQC 



00231 

042001 

DEV6 

i 3 I XBT 

' DP A » 

/hand, 17 

00232 

042002 


. S I XBT 

' DPB * 

/HAND, 20 

00233 

042003 


■ S I XBT 

'DPCt 

/HAND, 21 

00234 

000002 


2 



00235 

042023 


• S I XBT 

1 DPS j 1 

/disk done 

00236 

120000 





00237 

706341 


706341 



00240 

042023 


i S I XBT 

*OPSE' 

/DISK Error 

00241 

050000 





00242 

706361 


706361 



00243 

152401 

DEV7 

i S I XBT 

'MTA* 

/HAND, 22 

00244 

152403 


, SIXBT 

'MTC* 

/HAND, 23 

00245 

152406 


i S J XBT 

' MTF » 

/HAND, 24 

00246 

000001 


1 


/I SKIP 

00247 

152423 


, SIXBT 

»MTSr» 

/magnetic tape done on error 

00250 

060000 





00251 

707341 


707341 



00252 

142001 

DEV10 

, SJXBT 

*|_PA* 

/HAND, 25 

00253 

000001 


1 


/I SKIP 

00254 

142304 


i S I XBT 

'LSOF» 

/line printer done 

00255 

060000 





00256 

706501 


706501 





OZ- 


00257 

030402 

DEVU 

i S I XBT 

'CQBt 

/HAND, 26 

00260 

000002 


2 


/2 SKIPS 

0026}. 

220323 


» S I XBT 

•RCSF' 

/CARO READER 

00262 

060000 





00263 

706701 


706701 



00264 

220323 


t S 1 XBT 

'RCSD* 


00265 

040000 





00266 

706721 


706721 



00267 

262001 

DEV12 

i S I XBT 

* VPA i 

/HAND, 27 

00270 

000001 


1 


/I SKIP 

00271. 

230404 


, S I XBT 

' SOUF • 

/display 

00272 

060000 





00273 

700521 


700521 



00274 

262401 

DEV13 

, S I XBT 

'VTA' 

/HAND, 30j V T SCOPE DISPLAY 

00275 

000001 


1 


/l skip; light penjpush button 

00276 

232004 


i S I XBT 

' SPU I » 

/INTERNAL AND EXTERNAL STOP 

00277 

110000 





00300 

703121 


703121 


/o« edge violation ON VT 

00301 

262701 

DEV14 

.sixbt 

1 VWA i 

/HAND, 31! WRITING TABLET 

00302 

000001 


1 


/l SKIP 

00303 

272423 


.SIXBT 

'WTS«' 

/PEN CONTACT WITH TABLET 

00304 

130000 





00305 

703261 


703261 



00306 

141301 

DEV15 

.SIXBT 

'LKAt 

/HAND 32; VT KEYBOARD LK35 

00307 

000001 


1 


/I SKIP 

00310 

232013 


. S I XBT 

'SPKF» 

/L*35 KEYBOARD DONE 

00311 

060000 





00312 

704101 


704101 





HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 



READER'S COMMENTS 


DOS - SGEN 
DEC-15-YWZB-DN12 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability . 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 
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